home *** CD-ROM | disk | FTP | other *** search
/ Plug-In Power Pack for Netscape Communicator / Plug-In Power Pack for Netscape Communicator.iso / plugins / dataviews / dvtools / examples / utilities / readme.txt < prev    next >
Encoding:
Text File  |  1997-05-08  |  5.0 KB  |  147 lines
  1. This directory contains the following utilities that perform operations on 
  2. view files:
  3.  
  4. ViewDump.c: Prints the contents of a view file.
  5. viewconv.c: Converts a view from ASCII to binary or vice versa. Also 
  6.         converts pre-8.0 dynamics to the current format.
  7. tx2vt.c: Converts text objects (VOtx) to vector text objects (VOvt).
  8. vt2tx.c: Converts vector text objects (VOvt) to hardware text objects (VOtx).
  9. SetInputFlag.c: Sets the REDRAW_ON_UPDATE flag to YES for all input objects.
  10.  
  11. The utilities are furnished as source code. See the descriptions below for 
  12. instructions on how to build and use each utility.
  13.  
  14. ---------------------------------------------------------------------
  15.  
  16. Copy the executable to <dataviews>\bin and execute it using:
  17.  
  18.     (utility-name) (appropriate parameters)
  19.  
  20. ---------------------------------------------------------------------
  21.  
  22. ViewDump.c:  Prints the contents of a view file.
  23.  
  24. TO BUILD:    nmake viewdump.exe
  25.  
  26. SYNOPSIS:    viewdump <viewfile>
  27.  
  28. To run ViewDump.c under Windows NT:
  29.  
  30.     1.  Open an MS-DOS command prompt.
  31.  
  32.     2.  Type: viewdump <view_file>
  33.  
  34. The results are sent to stdout.
  35.  
  36. DESCRIPTION: This program examines a view file and prints out certain 
  37. content information. The output is divided into two sections, one on the 
  38. data sources and one on the drawing object. The data source section lists 
  39. information about each data source and data source variable. The drawing 
  40. object section lists information about certain objects and their subobjects. 
  41. The following kinds of objects are described:
  42.  
  43.     drawings
  44.     subdrawings
  45.     graphs
  46.     named objects
  47.     dynamic objects (color objects and dynamic objects)
  48.  
  49. EXAMPLE:    viewdump view1.v
  50.  
  51. ---------------------------------------------------------------
  52.  
  53. viewconv.c:  Converts a view from ASCII to binary or vice versa. Also converts 
  54. pre-8.0 dynamics to the current format.
  55.  
  56. TO BUILD:    nmake viewconv.exe
  57.  
  58. SYNOPSIS:    viewconv <save format> <input view> <output view> 
  59.         [<searchpath>]
  60.  
  61. DESCRIPTION:    The first argument determines which format the input view is 
  62. converted to. 
  63.  
  64. The available options are: 
  65.  
  66.     a  Save as an ASCII view file
  67.     b  Save as a Binary view file
  68.     d  Convert pre-8.0 dynamics
  69.  
  70. Valid combinations are: 
  71.  
  72.     a   save ASCII, do not convert dynamics
  73.     b   save Binary, do not convert dynamics
  74.     ad  save ASCII, convert dynamics
  75.     bd  save Binary, convert dynamics
  76.     d   save Binary, convert dynamics
  77.  
  78. If the view contains graphs, the search path parameter must include the 
  79. directory that contains dispform.stb or its equivalent.
  80.  
  81. The <input view> and <output view> can be the same. However, this should be 
  82. done with care since the view could be lost if a disk i/o problem occurs.
  83.  
  84. EXAMPLE:    viewconv ad in.v out.v  
  85.  
  86. ---------------------------------------------------------------
  87.  
  88. tx2vt.c: Converts text objects (VOtx) to vector text objects (VOvt).
  89.  
  90. TO BUILD:    nmake tx2vt.exe
  91.  
  92. SYNOPSIS:    tx2vt <device-string> <viewfile-source> <viewfile-destination>
  93.         [<fontfile>] {[<fontheight> <fontwidth>] [<scale>]}
  94.  
  95. DESCRIPTION: Converts all hardware text objects in a viewfile to software-
  96. generated vector texts. The regular roman.vf font is used unless otherwise 
  97. specified and sizes are scaled to match the original hardware text as 
  98. closely as possible. The utility correctly converts all hardware text in 
  99. included subdrawings; hardware text in referenced subdrawings is *not* 
  100. converted. Preserves any dynamics associated with the hardware text object.
  101.  
  102. EXAMPLE:    tx2vt w in.v out.v gothic.vf
  103.  
  104. ---------------------------------------------------------------
  105.  
  106. vt2tx.c: Converts vector text objects (VOvt) to hardware text objects (VOtx).
  107.  
  108. TO BUILD:    nmake vt2tx.exe
  109.  
  110. SYNOPSIS:    vt2tx <device-string> <viewfile-source> <viewfile-destination> 
  111.         [<fontsize>]
  112.  
  113. DESCRIPTION:  Converts all vector text fonts in a viewfile to hardware text 
  114. fonts. If the user specifies a fontsize (1,2,3, or 4) then the program will 
  115. set the hardware font to that size. If no fontsize is specified, then the 
  116. program uses the largest font that will fit in the same area when the view 
  117. is drawn to the full screen.
  118.  
  119. Once the changes are made the user should be able to go into DV-Draw and 
  120. make any additional changes if necessary. The utility will correctly convert 
  121. all vector text objects in included subdrawings; referenced subdrawings will 
  122. be left as is.
  123.  
  124. EXAMPLE:    vt2tx w:=600x500+0+0 in.v out.v 2
  125. ---------------------------------------------------------------
  126.  
  127. SetInputFlag.c: Sets the REDRAW_ON_UPDATE flag to YES for all input objects in 
  128. the specified view.
  129.  
  130. TO BUILD:    nmake setinputflag.exe
  131.  
  132. SYNOPSIS:    setinputflag <viewfile> <viewfile> ... <viewfile>
  133.  
  134. DESCRIPTION: Sets the REDRAW_ON_UPDATE flag to YES for all input objects in 
  135. the specified view. Does not change the flag on any input objects that are 
  136. widget-based. For all affected input objects, also changes the flag for all 
  137. embedded input objects.
  138.  
  139. EXAMPLE:    setinputflag view1.v view2.v view3.v
  140.  
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.